home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / com_and3.zip / PC-2-PC.DOC < prev    next >
Text File  |  1989-10-09  |  20KB  |  825 lines

  1. COM-AND Inter-PC File transfer
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.           -----------------------------------------
  18.             COM-AND Inter-PC File transfer
  19.           Script based file transfer for the IBM PC
  20.           -----------------------------------------
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for
  33.     any number of machines, for purposes of evaluation.  The author
  34.     offers COM-AND and its accessory programs as a package, as
  35.     "shareware".  If you USE the program a registration of $35.00 is
  36.     required.  The author may be reached:
  37.  
  38.  
  39.                  CABER Software
  40.                  R. (Scott) McGinnis
  41.                  P.O. Box 3607 Mdse Mart
  42.                  Chicago, IL 60654-0607
  43.  
  44.                  PLINK, GEnie id: TARTAN
  45.                  CIS id: 73147,2665
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 1.0: 891009
  55.  
  56. COM-AND Inter-PC File transfer
  57.  
  58.  
  59.                  Table of Contents
  60.                  -----------------
  61.  
  62. I.    Introduction  .............................................. page 1
  63.  
  64. II.    Installing the script ...................................... page 2
  65.  
  66. III.    Script initialization ...................................... page 3
  67.  
  68. IV.    File transfers ............................................. page 5
  69.  
  70. V.    Exit ....................................................... page 7
  71.  
  72. VI.    DOS gateway ................................................ page 8
  73.  
  74. VII.    Program Requirements ....................................... page 9
  75.  
  76. VIII.    Program and Author Information    ............................ page 10
  77.  
  78.  
  79.                 Appendices
  80.                 ----------
  81.  
  82.  
  83. A.    Null modem  ................................................ page 11
  84.  
  85. B.    Async port speeds .......................................... page 12
  86.  
  87. C.    Modem configuration ........................................ page 13
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109. Version 1.0: 891009
  110.  
  111. COM-AND Inter-PC File transfer                         Page   1
  112.  
  113.  
  114. I.    Introduction
  115.  
  116.  
  117.     A. What is COM-AND?
  118.  
  119.  
  120.        COM-AND for the IBM PC and compatibles is a communications
  121.        program that may be used by itself, or with several integrated
  122.        accessory programs (which themselves may be used independantly of
  123.        COM-AND).  COM-AND provides standard comm program functions:  a
  124.        dialing directory, macros, disc logging, binary and ASCII file
  125.        transfers, scripted execution and so on.
  126.  
  127.  
  128.     B. The PC-2-PC script
  129.  
  130.  
  131.        This document details the PC-2-PC script released independantly of
  132.        COM-AND.  The script supports
  133.  
  134.        o    Direct and dialed connection of two PCs
  135.  
  136.        o    Current directory listings of each PC (on both PCs)
  137.  
  138.        o    Change drive/directory from either PC on either PC
  139.  
  140.        o    Wild card multiple file transfer from/to either PC
  141.  
  142.        o    Selected file transfer from/to either PC
  143.  
  144.        o    DOS gateway during script execution
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Version 1.0: 891009
  165.  
  166. COM-AND Inter-PC File transfer                         Page   2
  167.  
  168.  
  169. II.    Installation
  170.  
  171.  
  172.     A. Install COM-AND
  173.  
  174.  
  175.        Refer to the COM-AND release documents (README.DOC and COM-AND.
  176.        DOC) for the description of COM-AND installation, please.
  177.  
  178.  
  179.     B. Placing PC-2-PC.CMD
  180.  
  181.  
  182.        The script file PC-2-PC.CMD should be placed in the COM-AND
  183.        default subdirectory.  If you use the environment variable
  184.        "COM-AND="..., PC-2-PC should be placed in the subdirectory
  185.        indicated by that environment variable.  Otherwise, place the
  186.        script in the same subdirectory as COM-AND.
  187.  
  188.  
  189.     C. (optional) Create a batch file to invoke the script
  190.  
  191.  
  192.        Optionally, you may create a batch file to invoke the script.
  193.        PC-2-PC is an interpreted script...    and therefore will give the
  194.        best performance if executed from a RAMDisk.  If you have such a
  195.        beast, use it!  [Folk more modern (than the author) who use
  196.        cacheing utilities may freely ignore this advice.]
  197.  
  198.  
  199.        PC-2-PC will connect to another machine either through a dialed
  200.        number or by direct conenct.  If you are setting up a direct
  201.        connect, using an async port other than the usual modem port (I
  202.        myself diasble my mouse...), a batch file is particularly helpful.
  203.        For example, I have a batch file to invoke this script:
  204.  
  205.             c:
  206.             cd\prod
  207.             copy pc-2-pc.cmd e:
  208.             com-and com1 115k /fe:pc-2-pc
  209.  
  210.        [My default COM-AND subdirectory is C:\PROD.  PC-2-PC.CMD is
  211.        placed in C:\PROD.  My RAMDisk is E:.  The mouse serial port
  212.        is COM1 (my modem and my COM-AND's default is COM2).  "19k" in
  213.        COM-AND's run command sets the COM1 async port speed to 19.2.
  214.        The "/fe:pc-2-pc" in COM-AND's run command executes the script
  215.        after COM-AND's load- time initialization.]
  216.  
  217.  
  218.  
  219. Version 1.0: 891009
  220.  
  221. COM-AND Inter-PC File transfer                         Page   3
  222.  
  223.  
  224. III.    Script initialization
  225.  
  226.  
  227.     When PC-2-PC.CMD is executed by COM-AND, there'll be a pause (the
  228.     length of which is determined by the speed of the disc on which the
  229.     script resides).  At its start, the script 'GOTO's the end, to draw
  230.     the window.  It may seem a silly way to write a script, but once
  231.     COM-AND has read the whole script once, performance will be improved
  232.     drastically!
  233.  
  234.  
  235.     The first thing PC-2-PC does is to open a double window.  The left
  236.     side of the screen will always a list of files in the current subdir-
  237.     ectory on the current machine.    The right side will be the subdirec-
  238.     tory on the other machine once you're connected.
  239.  
  240.  
  241.     Once the window opens, PC-2-PC begins building and displaying the
  242.     current subdirectory.  Again, this may take a bit of time... be
  243.     patient.  When all's done, a window will open over top of the file
  244.     list, prompting for action.
  245.  
  246.  
  247.     At this point, you need to see that COM-AND and the PC-2-PC script
  248.     are ready to connect on the machine you with which wish to talk.
  249.  
  250.  
  251.     With both machines ready to connect, on one, it doesn't matter which,
  252.     select either:
  253.  
  254.            2) Wait for direct connect
  255.            4) Wait for call connect
  256.  
  257.     If you are making a direct connect, you will be prompted to allow
  258.     port and speed specification(s).  A carriage return alone at this
  259.     point will start the 'waiting'.  If you are making a dialed connect,
  260.     the script simply goes into an autoanswer mode waiting for a call.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. Version 1.0: 891009
  275.  
  276. COM-AND Inter-PC File transfer                         Page   4
  277.  
  278.  
  279. III.    Script initialization (continued)
  280.  
  281.  
  282.     On the other machine, then select as appropriate:
  283.  
  284.            1) Direct connect
  285.            3) Dial the remote PC
  286.  
  287.     If you are making a direct connect, you will be prompted to allow
  288.     port and speed specification(s).  A carriage return alone at this
  289.     point will start connection.  If you are making a dialed connect,
  290.     you will be asked for a dialing directory number for the number to
  291.     be called and its parameters.    [Note the script only recognizes
  292.     300/1200/2400 baud connects.  Its easy to add speeds if need be.]
  293.  
  294.  
  295.     One point to emphasize:  The script that is to 'await' connection
  296.     should be started first.  The script 'making' the connect should then
  297.     be started.
  298.  
  299.  
  300.     If the two scripts recognize each other, they will begin by exchang-
  301.     ing subdirectory lists.  When the lists have been exchanged, the
  302.     script is ready to use.  If the two scripts do not connect, check the
  303.     settings (speed etc) used on both, and the null-modem (if used) and
  304.     try again.
  305.  
  306.  
  307.     In particular, if your attempting a direct connect, try a slower
  308.     speed connect...  the async port used may not be able to handle
  309.     very high speeds (see appendix B).
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. Version 1.0: 891009
  330.  
  331. COM-AND Inter-PC File transfer                         Page   5
  332.  
  333.  
  334. IV.    File Transfers
  335.  
  336.  
  337.     A. Wildcard transfer
  338.  
  339.  
  340.        Selection 'W' from the main window will prompt for direction (are
  341.        you sending or receiving files) and a wildcard file specification.
  342.        Select a direction ('S' or 'R'), and specify the file(s) to be
  343.        transferred.  A wildcard specification has the form:
  344.  
  345.            [d:][\path...]<filespec>
  346.  
  347.        where "d:" is an optional drive spec, "\path" is an optional
  348.        subdirectory specifier and filespec is a file name with optional
  349.        "*"s and "?"s that DOS users love and respect.  For example:
  350.  
  351.            C:\PROD\COM-AND.*
  352.  
  353.        would move all COM-AND files from one machine to the other.    [By
  354.        the way, it doesn't hurt anything if you move COM-AND.EXE over the
  355.        copy you executed while its executing.  It DOES hurt things if you
  356.        change the script file... don't touch a script file while its
  357.        executing!]
  358.  
  359.  
  360.        If there is at least one file matching the wildcard specification
  361.        you gave, on the appropriate machine, the transfer will begin.
  362.  
  363.  
  364.        If a file being transferred via a wildcard specifier duplicates a
  365.        file already existing, the new file's name will be modified;  a
  366.        "$" will be placed in the last character position.  For example,
  367.        if COM-AND.EXE were copied through wildcard transfer into a sub-
  368.        directory already containing COM-AND.EXE, the new file would be
  369.        named COM-AND.EX$.
  370.  
  371.  
  372.        The wildcard transfer moves multiple files from one machine to the
  373.        other in one direction at a time.  The file name given the sender
  374.        may be fully qualified (with drive and path).  The receiver places
  375.        the files received on the current subdirectory.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. Version 1.0: 891009
  385.  
  386. COM-AND Inter-PC File transfer                         Page   6
  387.  
  388.  
  389. IV.    File Transfers (continued)
  390.  
  391.  
  392.     B. Selected file transfer.
  393.  
  394.        You may select up to 5 files from the current local machine's
  395.        window, and 5 files from the current remote machine's window for
  396.        transfer.  The direction of the transfer is implicit.  Files are
  397.        selected with a point-and-shoot method:
  398.  
  399.            Cursor right   Selects the remote window
  400.            Cursor left      Selects the local window
  401.            PgUp       Moves the current window (local or remote)
  402.                   up 20 files
  403.            PgDn       Moves the current window (local or remote)
  404.                   down 20 files
  405.            Home       Moves the current window (local or remote)
  406.                   to the first 20 files
  407.            End          Moves the current window (local or remote)
  408.                   to the last page of files
  409.            Cursor up      Moves a scroll bar up the list of files
  410.            Cursor down      Moves a scroll bar down the list of files
  411.  
  412.  
  413.        Position the scroll bar to a file to be transferred.  Then type
  414.        'S'.  A window will open and the current list of selections is
  415.        displayed.  You are asked to verify the selection with 'y' or 'n'.
  416.  
  417.  
  418.        With one or more files selected, 'T' will begins the transfer.
  419.  
  420.  
  421.        If a file being transferred via selection duplicates a file
  422.        already existing, the old file is replaced by the new file.
  423.  
  424.  
  425.        The selected transfer moves multiple files from one machine to the
  426.        other in any direction.  Files must be selected from the current
  427.        subdirectory (local and remote)... if you change directory on
  428.        either side, the list of selected files is cleared.
  429.  
  430.  
  431.        The receiver places the files received on its current sub-
  432.        directory.
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. Version 1.0: 891009
  440.  
  441. COM-AND Inter-PC File transfer                         Page   7
  442.  
  443.  
  444. V.    Exit
  445.  
  446.  
  447.     The PC-2-PC script will terminate when ESC or 'E' is pressed in the
  448.     main window.  [ESC may be used in other windows to cancel a prompt.]
  449.  
  450.  
  451.     If the script is currently linked to another machine, the script on
  452.     the other machine should exit automatically.
  453.  
  454.  
  455.     If the connection was made via a dialed call, a HANGUP is performed.
  456.     Temporary files created by the script are deleted.  A general
  457.     clean-up is performed.
  458.  
  459.  
  460.     The PC-2-PC script terminates both itself and COM-AND on exit (you
  461.     are returned to the DOS prompt).
  462.  
  463.  
  464.     You may wish to modify the script to take some other action on exit.
  465.     For example, you might wish it simply to exit to COM-AND and not to
  466.     DOS.  The script is written to have one single exit, labelled "EXIT:"
  467.     Code is provided in the "EXIT:" procedure to exit to COM-AND and not
  468.     DOS... however, if it is your intention to retain the open line,
  469.     beware of the RESET command there.  RESET closes the current port and
  470.     re-opens the default communications port.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Version 1.0: 891009
  495.  
  496. COM-AND Inter-PC File transfer                         Page   8
  497.  
  498.  
  499. VI.    DOS gateway
  500.  
  501.     At the main window, you may shell-to-DOS at any time with the same
  502.     keystroke as used by COM-AND for the purpose: Alt-F10.
  503.  
  504.  
  505.     If there is memory, a new copy of the SHELL (usually COMMAND.COM) is
  506.     executed.  A connection, if made, is not lost during a shell
  507.     operation (unless you do something like load another comm program!).
  508.  
  509.  
  510.     When you exit the shell, you are returned to COM-AND and the PC-2-PC
  511.     script.  If your shell is COMMAND.COM, typing 'exit' will terminate
  512.     the shell.
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Version 1.0: 891009
  550.  
  551. COM-AND Inter-PC File transfer                         Page   9
  552.  
  553.  
  554. VII.    Program requirements
  555.  
  556.  
  557.     This program can only function on an IBM PC or DOS compatible
  558.     machine.  COM-AND does direct to screen buffer fetches and stores
  559.     (unless BIOS screen updates are directed using the /C switch or the
  560.     Alt-O options menu).
  561.  
  562.  
  563.     COM-AND is TopView aware even without the /C switch or Alt-O option.
  564.  
  565.  
  566.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  567.     soft Mouse if one is available...
  568.  
  569.  
  570.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  571.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  572.  
  573.  
  574.     COM-AND (Version 2.5) requires 248K for itself.  You need 384K
  575.     take advantage of the DOS Gateway and to load accessories.
  576.  
  577.  
  578.     This script requires a 300, 1200 or 2400 baud modem (others could
  579.     be supported with modification to the script) or a null-modem to an
  580.     asynchronous port.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604. Version 1.0: 891009
  605.  
  606. COM-AND Inter-PC File transfer                         Page  10
  607.  
  608.  
  609. VIII.    Author information
  610.  
  611.  
  612.     COM-AND was written using Microsoft Macro-Assembler.  The author
  613.     likes assembler.  Assembly language is an entirely appropriate
  614.     vehicle for some of the program, and a not-inappropriate vehicle
  615.     for the rest of it.  Everything, in moderation...
  616.  
  617.  
  618.     The author of this script was R.  Scott McGinnis of Chicago, IL.
  619.     My PLINK and GEnie ID:    TARTAN, and CIS id:  73147,2665.
  620.     Comment and suggestions are welcomed:
  621.  
  622.              CABER Software
  623.              R. (Scott) McGinnis
  624.              P.O. Box 3607 Mdse Mart
  625.              Chicago, IL 60654-0607
  626.  
  627.  
  628.     My wife, Elizabeth, has made this script and COM-AND itself possible.
  629.     She even indulges on-line, now and then!  To her I offer my love,
  630.     respect and warmest moments <grin>.
  631.  
  632.  
  633.     This script (Version 1.0) may be distributed freely (but it isn't a
  634.     whole lot of use without COM-AND).  Any improvements that are
  635.     returned to the author will get attention...  errors reported to the
  636.     author will be corrected.  COM-AND is shareware.  If COM-AND is USED
  637.     after a reasonable period of evaluation, a registration of $35.00 is
  638.     required.  If used for a commercial application, registration is
  639.     mandatory.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659. Version 1.0: 891009
  660.  
  661. COM-AND Inter-PC File transfer                         Page  11
  662.  
  663.  
  664. A.    Null modem
  665.  
  666.     This script has been used successfully with the following null modem:
  667.  
  668.     RS-232 pins            RS-232 pins
  669.     -----------            -----------
  670.     (fg)   1 ----------------------  1  (fg)
  671.     (tx)   2 --------\   /---------  2  (tx)
  672.                X
  673.     (rx)   3 --------/   \---------  3  (rx)
  674.     (gnd)  7 ----------------------  7  (gnd)
  675.  
  676.     (cts)  4 -+             +-  4  (cts)
  677.           !             !
  678.     (rts)  5 -+             +-  5  (rts)
  679.  
  680.     (dsr)  6 -+             +-  6  (dsr)
  681.     (cd)   8 -!             !-  8  (cd)
  682.           !             !
  683.     (dtr) 20 -+             +- 20  (dtr)
  684.  
  685.     In other words, Pin 2 of one to pin 3 of the other, and pin 3 of the
  686.     first to pin 2 of the other.  On each side, jumper pins 4 and 5, and
  687.     jumper pins 6, 8, and 20.  Connect the pin 7s of each machine, and
  688.     the pin 1s.
  689.  
  690.  
  691.     This null modem will work for many purposes.  This script does not
  692.     look at CD if a direct connection is used (CDRESPECT OFF).  Tieing CD
  693.     to DSR on each side would provide an active carrier detect.  Other
  694.     applications may work better with other null modem connections.
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714. Version 1.0: 891009                           Appendices
  715.  
  716. COM-AND Inter-PC File transfer                         Page  12
  717.  
  718.  
  719. B.    Async port speeds
  720.  
  721.  
  722.     The 8250 UART used in the original asynchronous port (and some
  723.     modem) circuits can theoretically run at speed up to 115K baud.
  724.     However, in fact, many 8250 chips were found to 'wobble' their
  725.     timings at high speeds.
  726.  
  727.  
  728.     Pin identical replacement UARTS are available that solve the problem.
  729.     The reader will find a discussion of the problem and sources for
  730.     replacements in Chuck Forsberg's DSZ document, if interested.
  731.  
  732.  
  733.     The capability of one machine's UART determines the maximum speed
  734.     of this script.  As errors occur, the transfer efficiency drops.
  735.     Drastically.
  736.  
  737.  
  738.     COM-AND implements only 'relaxed' protocols.  This means that time-
  739.     outs are very long in COM-AND - suitable for the network/switched
  740.     environment, but not for direct connects.  When a character is
  741.     dropped, or errored, COM-AND waits a fixed time before retransmitting
  742.     or requesting a retransmit.  As the line speed increases, timeouts on
  743.     error reduce the overall efficiency.
  744.  
  745.  
  746.     The CPU clock speed will also have its toll.  COM-AND is a general
  747.     purpose communications program, accomodating software flow control
  748.     (XON/XOFF).  On slower machines, the overhead to check for XON/XOFF
  749.     becomes a limiting factor in the software's capability.
  750.  
  751.  
  752.     If  you use this script, experiment with speed settings.  If you find
  753.     any improvements that might be made, please inform the author.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Version 1.0: 891009                           Appendices
  770.  
  771. COM-AND Inter-PC File transfer                         Page  13
  772.  
  773.  
  774. C.    Modem Configuration
  775.  
  776.  
  777.     COM-AND default values do not require your modem to be configured
  778.     in any particular manner.  However, certain features cannot be used
  779.     unless you configure your modem before you use COM-AND.
  780.  
  781.  
  782.     1. DTR (Data Terminal Ready)
  783.  
  784.        COM-AND, by default, hangs up using the command sequences defined
  785.        through the Alt-S setup (hangup and modem escape).  However, you
  786.        may alternately select 'Drop DTR to hangup' through the Alt-O
  787.        options.  Dropping DTR is the only way to hangup certain modems,
  788.        and is generally much faster than the command sequences.
  789.  
  790.  
  791.        Most Hayes compatible modems allow configuration of the DTR sense
  792.        through a switch-block.  If you wish to use DTR to hangup, be sure
  793.        that your modem follows the DTR signal.  Refer to the documenta-
  794.        tion provided with your modem to be sure that option switches are
  795.        set appropriately.
  796.  
  797.  
  798.     2. CD (Carrier Detect)
  799.  
  800.        COM-AND (presently) uses the CD sense line for several purposes.
  801.        The 'CONNECT' test supported in the script language, test for
  802.        carrier detect upon exit, and the file transfer protocols all
  803.        require that the modem report carrier detect.  True carrier detect
  804.        is the only way to determine if you are 'on-line' or 'off-line'.
  805.  
  806.  
  807.        Many Hayes compatible modems are sold with a carrier detect
  808.        override (in other words the modem reports carrier detect all the
  809.        time).  When carrier detect is overridden, COM-AND cannot detect
  810.        when carrier is lost during a file transfer or whether to ask if
  811.        you want to hangup when you exit.
  812.  
  813.  
  814.        Be sure that the modem is reporting true CD (instead of it just
  815.        saying 'yes').  Most Hayes compatible modems allow configuration
  816.        of the CD sense through a switch-block.  Refer to the documenta-
  817.        tion provided with your modem to be sure that option switches are
  818.        set appropriately.
  819.  
  820.  
  821.  
  822.  
  823.  
  824. Version 1.0: 891009                           Appendices
  825.